PC World Interactive 9/PC World Interactive 9 - Temmuz 1998.iso/muzik/RT223.EXE/RT_ENG.TXT

Text File | 1997-10-19 | 26KB | 818 lines

                      Real Tracker Version 2.23 manual
                 (c) Copyright 1996-1997 Arnaud HASENFRATZ



Contents

  1. Presentation
       1. What is Real Tracker ?
       2. Required configuration
       3. Features
  2. How to use Real Tracker
       1. Running the program
       2. The main menu
       3. The control bar
       4. Pattern editor
       5. Effects
       6. Instrument list
       7. Instrument editor
       8. Sample editor
       9. Instrument library
      10. Order
      11. Module vars
      12. Channels
      13. Scopes
      14. Loading and saving modules
      15. Configuration
  3. Futures improvements
  4. Greetings
  5. Contributors
  6. Legal informations
  7. How to register
  8. How to contact the author

1. Presentation

1.1 What is Real Tracker ?

Real Tracker is a "sound tracker", a software which allows to compose music
with digitized instruments. It does not need expansive material. It is also
possible to control external MIDI devices.

1.2 Required configuration

   * a PC with a 386 processor or better
   * 4 MB of RAM or more
   * MS-DOS 5.00 or more or Windows 95
   * a VESA compatible video card
   * a mouse
   * one of these sound cards :
        o Sound Blaster
        o Sound Blaster Pro
        o Sound Blaster 16
        o Gravis Ultrasound
        o InterWave based sound card (e.g. : Gravis Ultrasound PnP)

If your graphic card is not VESA 2.0 compatible, you should use a software
driver like UniVBE, the display will be faster.

1.3 Features

32 tracks, surround mode for each track.
up to 255 instruments.
up to 999 patterns.
up to 999 positions.
8 and 16 bits samples.
10 octaves.
Volume and panning envelopes support.
Support of all Protracker, Scream Tracker and FastTracker effects.
Automatic and intelligent GUS memory resampling (according to the quality
of the samples)
32 bits mixing routine with interpolation and volume ramping.
MIDI input and output support

Multi-windows graphical user interface : support modes from 640x400x256
to1280x1024x256.
Instrument and sample editor.
Full user definable keys.

Work in 32 bits protected mode.

2. How to use Real Tracker

2.1 Running the program

Command line :

RT2 <name> <options...>

If a module name is specified, it will be loaded and played at start-up.

Options :

 /Sx    Select an other card, that the auto detected one
        * 0 : no sound
        * 1 : Sound Blaster
        * 2 : Gravis Ultrasound
        * 3 : AMD InterWave
 /Axxx  Specify the sound device port address
 /Ixx   Specify the sound device IRQ number
 /Dx    Specify the sound device DMA channel
 /BxxxxxSpecify the DMA buffer size on Sound Blaster cards. To play music
        in background under a multitask OS, it is useful to increase this
        value.
 /T     Use the PC timer instead of the sound device timer (GUS and
        InterWave)
 /F     Disable linear frame buffer for display. This option must be
        specified if you use VESA 2.00 extensions like UniVBE and your
        video card does not support linear addressing.

2.2 The main menu

It appears when you click on the right mouse button and allows to open the
other windows.

The "idle mode" option is displayed when you use a multitask environment
like Windows 95. It allows to disable the display in order to switch to an
other task.

2.3 The control bar

It allows to make global operation and to see information about the module.


 New               Clear the instruments, the notes data or all the module
 Load              Open the load dialogue box
 Save              Save the edited module under the actual name. To change
                   the name, use the "Save as..." function from the main
                   menu
 Rewind and forwardAllows to move position by position in the module
 Play              Start to play. If the playing is stopped, it restart at
                   the beginning of the current pattern. If the pause key
                   is pressed, the playing restart at the current line. If
                   the module is already playing, it restart at the
                   beginning of the current pattern
 Rep               When this key is pressed, the current pattern is looped
 Oct               Display and allows to change the current octave used
                   for the keyboard
 Tracks            Change the number of tracks. When this value is
                   decreased, the tracks are not cleared from the memory
                   and it is still possible to get it by increasing the
                   value again.
                   The number and the field indicate the current
                   instrument
 Library           Open the instruments and samples library. It is
                   possible to open several windows.

2.4 Pattern editor

This window is designed to edit the music.

The partition is displayed in tracks. Each track has four columns :
*the note
*the instrument number
*the left effect
*the right effect

In order to edit anything, the "Edit" button must be pressed. This button
can also be activated with the space bar.

The notes can be entered with a disposition which simulate a piano keyboard
:

    Note :        C# D#    F# G# A#    C# D#    F# G# A#    C# D#
        │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │
        │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │ │ ││ ││ │ │ │ ││ │ │
    Touche :    │ │S││D│ │ │G││H││J│ │ │2││3│ │ │5││6││7│ │ │9││0│ │
                │ └┬┘└┬┘ │ └┬┘└┬┘└┬┘ │ └┬┘└┬┘ │ └┬┘└┬┘└┬┘ │ └┬┘└┬┘ │
                │ Z│ X│ C│ V│ B│ N│ M│ Q│ W│ E│ R│ T│ Y│ U│ I│ O│ P│
                └──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┴──┘
    Note :        C  D  E  F  G  A  B  C  D  E  F  G  A  B  C  D  E
                  Octave -1            Octave 0             Octave +1

The other columns are edited with the standard keys.

The two effect columns allows to enter commands to control volume,
frequency, panning or to change the way of playing.
Warning : the effects use hexadecimals parameters, that is in base 16. So,
the digits are : 0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F. For example, we will
count like this: 1,2,3,4,5,6,7,8,9,A,B,C,D,E,F,
10,11,12,13,14,15,16,17,18,19,1A,1B,1C,1D,1E,1F,20 etc...

The button with the track number is used to disable the playing of the
track If you click on this button with the right mouse button, the other
tracks are disabled and the track is in solo mode.
The "Lock" buttons are used to disable the edition of a track The right
mouse button works with the same principle.
Each track has a field to give it a name. This is useful when you work with
many tracks.

Is it also possible to give a name to the pattern with the "Name" field.
The "Len" counter allows to change the pattern length. The maximum length
is 999 lines.

The "Step" counter choose the number of line that the cursor advance when a
note is entered.

The menus make operation on the selected block, the current track or the
current pattern.
The block can be selected with Shift and the cursor keys or with the mouse.

Each menu has "Cut", "Copy" and "Paste" functions. The "Advanced Paste"
function, paste only the selected columns in the track. If the
"Transparent" option is selected, the events already present in the pattern
will not be overwritten.
The interpolate function create a number sequence according to the first
and last effect parameter in the selected block This is useful to make
fade-in and fade-out.
The last menu allows to select one of the three edit modes :
*Single : to enter note by note
*Chords : to enter chords by pressing several keys in the same time
*Multi : the cursor move one track right at each note. The "Lock" can be
used to avoid unwanted tracks.

2.5 Effects

The name and the syntax of the effects are the same that those used by
FastTracker 2. Some Scream Tracker 3 effects have also been implemented for
compatibility reason. These are designated by a lower case letter.

* 0 Arpeggio
* 1 Portamento up                      * EA Fine volume slide up
* 2 Portamento down                    * EB Fine volume slide down
* 3 Portamento to note                 * EC Note cut
* 4 Vibrato                            * ED Note delay
* 5 Portamento to note + Volume slide  * EE Pattern delay
* 6 Vibrato + Volume slide             * F Set speed/tempo
* 7 Tremolo                            * G Set global volume
* 8 Set panning                        * H Global volume slide
* 9 Sample offset                      * K Key off
* A Volume slide                       * L Set volume envelope position
* B Position jump                      * M Select MIDI controller
* C Set volume                         * P Panning slide
* D Pattern break                      * R Retrig + Volume slide
* E1 Fine portamento up                * SA Set high sample offset
* E2 Fine portamento down              * T Tremor
* E3 Set glissando control             * V Set MIDI controller value
* E4 Set vibrato control               * X Extra fine portamento
* E5 Set fine-tune                     * a Set speed (ST3)
* E6 Pattern loop                      * d Volume slide (ST3)
* E7 Set tremolo control               * e Portamento down (ST3)
* E8 Set panning                       * f Portamento up (ST3)
* E9 Retrig                            * k Vibrato + Volume slide (ST3)

Description :

*0xy Arpeggio

     Cycle quickly between these three notes : the actual note, this note
     +x semitones and this note +y semitones.

*1xx Portamento up

     Increase the frequency at each tick at the xx speed.

*2xx Portamento down

     Increase the frequency at each tick at the xx speed.

*3xx Portamento to note

     Progressively move the pitch to reach the associated note.

*4xy Vibrato

     Vibrate the pitch at speed x and depth y

*5xx Portamento to note + Volume slide

     Combination of 3xx and Axy : Progressively move the pitch to reach the
     associated note and increase or decrease the volume according to the
     associated parameter.

*6xx Vibrato + Volume slide

     Combination of 4xx and Axy : Vibrate the pitch and increase or
     decrease the volume according to the associated.

     with the same parameter that the last Axy command.

*7xx Tremolo

     Vibrate the volume at speed x and depth y

*8xx Set panning

     Set the panning position. 0h is left position and 80h the right
     position. A4h activate the surround mode..

*9xx Sample offset

     Begin the sample from offset xx*256. To reach the offsets >65536, use
     SAx.

*A0x Volume slide down

     Slide down the volume at speed x

*Ax0 Volume slide up

     Slide up the volume at speed x

*Bxx Position jump

     Jump to the song position xx

*Cxx Set volume

     Set the current volume to xx.

*Dxx Pattern break

     Jump to the next pattern and start at row xx. Warning : the xx
     parameter must be in decimal.

*E1x Fine portamento up

     Increase the pitch once

*E2x Fine portamento down

     Decrease the pitch once

*E3x Set glissando control

     Ifx=1, all Porta to note effects will be rounded to the nearest
     semitone

*E4x Set vibrato control

     Change the vibrato wave form :
     x=0 Sine
     x=1 Ramp down
     x=2 square

*E5x Set fine-tune

     Use the x fine-tune value

*E6x Pattern loop

     If x=0, mark the beginning of the loop, otherwise repeat the loop x
     times.

*E7x Set tremolo control

     Change the tremolo wave form :
     x=0 Sine
     x=1 Ramp
     x=2 Down

*E8x Set panning

     Set the panning position. 0 is the left position, F is the right
     position.

*E9x Retrig

     Restart the instrument every x ticks.

*EAx Fine volume slide up

     Increase the volume one time.

*EBx Fine volume slide down

     Decrease the volume one time.

*ECx Note cut

     Stop the instrument at the specified tick.

*EDx Note delay

     Delay the note for x ticks.

*EEx Pattern delay

     Stop the play for a delay of x rows.

*Fxx Set speed/tempo

     If x<20h set the number of ticks per rows, otherwise set the ticks
     frequency.

*Gxx Set global volume

     Set the global volume to xx.

*Hxx Global volume slide

     Works like the Axx command but change the global volume.

*K00 Key off

     End of note. It is better to use the Key Off sign.

*Lxx Set volume envelope position

     Set the volume envelope position to xx.

*Mxx Select MIDI controller

     Select a MIDI controller from 0 to 7Fh.

*Pxx Panning slide

     Works like the Volume slide command but move the panning position.
     Warning : the xx parameter is the number of semi positions per tick.

*Rxy Retrig + Volume slide

     Restart the instrument every x ticks and change the volume each time
     according to the y parameter :

     * y=0: 0 (no variation)
     * y=1: -1                * y=9: +1
     * y=2: -2                * y=A: +2
     * y=3: -4                * y=B: +4
     * y=4: -8                * y=C: +8
     * y=5: -16               * y=D: +16
     * y=6: 2/3*volume        * y=E: 3/2*volume
     * y=7: 1/2*volume        * y=F: 2*volume


*SAx Set high offset

     Begin the sample from offset x*65536. This command can be combined
     with 9xx.

*Txy Tremor

     Set the volume to zero for y ticks then set it back to the initial
     volume for x ticks.

*Vxx Set MIDI controller value

     This command must be used with Mxx.

     Example :
          ... .. ... M06
          ... .. ... V40
     This will send the message "Set controller 6h to 40h" to the MIDI
     output.

*X1x Extra fine portamento up

     Works like the portamento up command but the speed is divided by 4

*X2x Extra fine portamento down

     Works like the portamento down command but the speed is divided by 4

*axx Set speed (ST3)

     Set the number of ticks per rows.

*d0x Volume slide down (ST3)

     Slide down the volume at speed x

*dx0 Volume slide up (ST3)

     Slide up the volume at speed x

*dFx Fine volume slide down (ST3)

     Decrease the volume one time.

*dxF Fine volume slide up (ST3)

     Increase the volume one time.

*exx Portamento down (ST3)

     Decrease the frequency at each tick at speed xx.

*eFx Fine portamento down (ST3)

     Decrease the frequency at each tick at speed xx.

*eEx Extra fine portamento down (ST3)

     Works like the fine portamento down command but the speed is divided
     by 4

*fxx Portamento up (ST3)

     Increase the frequency at each tick at speed xx.

*fFx Fine portamento up (ST3)

     Increase the frequency at each tick at speed xx.

*fEx Extra fine portamento up (ST3)

     Works like the fine portamento up command but the speed is divided by
     4

*kxy Vibrato + Volume slide (ST3)

     Combination of 4xx and dxy : Vibrate the pitch at speed x and depth y
     and increase or decrease the volume with the same parameter that the
     last Axy command.

2.6 Instrument List

This window display all the instruments used in the module. The "Add" and
"Sub" buttons increase and decrease the number of instruments. The "Edit"
button open the Instrument Editor.

2.7 Instrument Editor

This window define all the parameters of the instrument. An instrument
contain one or several samples.

The samples are assigned to the notes. The key split is displayed on the
piano keyboard. To change the key split, choose a sample in the list and
select the notes with the mouse on the piano keyboard. It is also possible
to test the instrument on the piano with the right mouse button.

The settings above the piano belong to the selected sample.

 Default volumeIt is the volume used when no volume effect is specified on
               the track
 Base volume   Set the volume independently from the default volume and
               volume effects
 Base note     Note played by the sample at his base frequency
 Base freq     Frequency at which the sample was recorded
 Length        Length in number of elementary samples
 Loop          Switch between no loop, loop and bi-directional loop mode.
               Warning : for the moment, bi-directional loops are note
               supported on Sound Blaster cards
 Panning       Set the sample panning. It will be effective only if the
               "Default panning" option is selected in the "Misc" group.
The other settings are divided in three groups.
*Volume

This group define the volume envelope. It will be used if the corresponding
box is checked. The envelope define a volume variation applied to the
instrument. One pixel in the envelope editor corresponds to one tick. The
left mouse button add or move the points. The right button delete them. If
the "Sustain" option is used, the envelope will stop at the sustain point
until a Key Off is played.
*Panning

Define the panning envelope. It works like the volume envelope. The left
side is below the axis and the right side is above.
*Misc
 Fadeout        Speed at which the volume decrease after a "Key off"
 Vibrato sweep  Time in ticks until the auto-vibrato reach is maximal
                amplitude.
 Default panningIf this box is checked, the instrument will set its own
                panning to the track it is played. When you load a MOD or
                S3M file, this option is disabled for all instruments.
                When you load an XM file, the option is enabled for all
                instruments
*MIDI out

This group set the way the instrument playing will be converted in MIDI
events

 Enable instrument MIDIEnable the MIDI translating

 Mute sample           Disable the playing of the instrument on the sound
                       card
 MIDI channel          MIDI channel that the instrument will use
 MIDI program          Program which will be used to play the instrument

 Transpose             The note will be transposed by this number of
                       semi-tones before being sent to the MIDI output
 Bender range          Number of semi-tones that the pitch-bend can reach
 Base volume           MIDI base volume
                       If this is checked, the volume associated to a note
                       will be converted into velocity. Other volume
 Use volume as velocitychanges will be translated in MIDI controller 7
                       change. If not, the velocity will always be equal
                       to "Base volume" and the MIDI controller 7 will be
                       used.

2.8 Sample editor

Buttons :

 Play Play the selection
 +/-  Zoom in/out
      1. Show all the sample
 All
      2. Select all
 Sel  Show the selection
 1:1  Zoom to the screen ratio
 Undo Cancel the last action
 Ins  Insert silence at the beginning of the selection
 Del  Delete the selection
 Trim Delete all but the selection
 Cut  Copy selection to clipboard and delete
 Copy Copy selection to clipboard
 PastePaste clipboard at the beginning of the selection
 Mix  Mix the clipboard with the sample at the beginning of the selection
The effect menu :

 Volume  Changes the volume of the selection
 MaximizeIncreases the volume as high as possible without saturation
 Fade    Gradually changes the volume throughout the selection
 Silence Mute the selection
 Reverse Reverse the selection
 Echo    Produces an echo. Reverb : enables regeneration of the echo
 Invert  Turns the sound up-side-down
         Makes the loop smoother. Before calling this function, you must
 Fix loopselect a transition range on the first or on the second loop
         point.

2.9 Instrument library

This window allows to load and save instruments and samples. You can test
an instrument before loading it by selecting it and entering notes with the
keyboard.

 Load I                    Load the selected instrument on the current
                           instrument.
 Save I                    Save the current instrument in the directory.
 RTI or XI                 Select the save file format of the instruments.
 Load S                    Load the selected sample on the current sample.
 Save S                    Save the current sample in the directory.
 RTS or RAW                Select the save file format of the instruments.
 Smp+Instr, Smp, Instr,    Select a filter for the directory list.
 *.*
You can load the following instrument files :
*RTI : Real Tracker
*XI : FastTracker 2

And the following sample files :
*RTS : Real Tracker
*IFF : FastTracker 2
*S3I : Scream Tracker 3
*WAV : Windows (only in mono)
*SMP, RAW, SND, SAM: raw data

2.10 Order

This window edits the position table which define the playing order of the
pattern.
The "Copy" button create a new pattern, insert it in the list and copy the
current pattern in it.

2.11 Module vars

This window sets the global variables of the module.

 Frequency tableSelect the way the frequency effects work
                * Periodic : the basic unit is based on a periodic table
                * Linear : there is always 64 units by semitones.
 Initial speed  Choose the number if ticks by pattern row
 Initial tempo  Choose the ticks frequency
                Ticks per second = Tempo/2.5

2.12 Channels

This window displays informations about the channels. The panning cursors
can be moved and the surround mode can be activated with the right mouse
button.

2.13 Scopes

The display mode can be changed with the right mouse button.

2.14 Loading and saving modules

The tracker can load the following formats :
*RTM : Real Tracker
*MOD, NST : Protracker
*S3M : Scream Tracker 3
*XM : FastTracker 2

Modules can be saved in RTM, MOD, XM or WAV.

If you save in XM and some instruments have not the " Default panning "
option selected, the program will calculate a panning for these instruments
according to the tracks on which the instrument is played.

2.15 Configuration

This dialogue box allows to set default directories, the display format,
the sound options and to modify the key map.

3. Futures improvements

*Dynamic voice allocation and support for 256 tracks

4. Greetings

I would like to thanks the following persons who have contributed to the
realization of this software.

Hardware lending:

*Philippe Malaisé : GUS Max
*Julien Nicolet : SB16
*Olivier Picard : his PC :-)

Beta-testing and ideas:

*Aurora / Devotion
*Dmitry Sintsov
*Frédéric Diebold

Documentations and tools :

*Mark Feldman : PCGPE
*Psi / Future Crew : S3M format / Scream Tracker
*Vogue & Mr H / Triton : XM format / FastTracker 2

Quality music:

*Necros
*Purple Motion / Future Crew
*Skaven / Future Crew
*Lizardking / Triton

5. Contributors list

*Harald Lapp
*Jean-Luc Dufour
*Guy Belvire
*Allen Vallières
*Frédéric Bujon
*Jérome Grandsire
*Daniel Azema
*Philippe Sam-long
*Jeff Zacher
*Yann Charlou
*Philippe Comte
*Jon Ussing
*Arnaud Bergougnoux
*Gabriel Reynaud
*Pascal Rouseau
*Pascal Moreau
*Jean-Philippe Barbier
*Jeroen Wingelaar
*Jean-Michel Marquez
*Jean-Claude Lallement
*Sébastien Pérales
*Léonard Billich
*Jean-Yves Theliou
*Didier Madrias
*Bruno Thibaut
*André Lindental
*Patrick Rivière
*Philippe Meisburger
*Fabien Guilloteau

6. Legal informations

*Use this software at your own risk : whatever happens, I cannot be
considered as responsible.
*This cannot be sold or distributed on a support which is sold (CD-ROM,
shareware-disks) without my written authorization.
*THIS VERSION OF REAL TRACKER CAN NOT BE USED PROFESSIONALLY OR
COMMERCIALLY. Music produced with this unregistered version may not be sold
EVEN AS SHAREWARE.

7. How to register

In registering, you get the following advantages :
*The full version of Real Tracker and ALL THE FUTURES VERSIONS. New
features of the full version :

   * access to resolutions higher than 640x480
   * save of redefined keys
   * undo function with 2000 levels
   * multiple sample editors
   * unlimited WAV saving of the modules

*you will have your name in the contributor list of the next version
*technical support by mail, e-mail and phone
*considerable reductions on my futures productions

To register, print or copy the "REGISTER.TXT" file, fill it out and send it
with your donation of 15 US Dollars (or 90 french Francs) at the address
below.
You will get the complete version in the next 7 days by mail or e-mail.
If you have an e-mail account, I will be able to send you regularly the new
versions. Otherwise, you will have to send me a 3"5 floppy disk and stamps
that I will use to send you back the updated version.

Warning : the basic registered version cannot be used in a firm. If you
need that, you must get the professional license by contacting me.

How to pay if you do not live in France :

You have two solutions :
*Use bank notes. Make sure the money is not visible in the envelope
*Draw a check in french Francs.

Do not send me a check in Dollars or in an other money than Francs because
the bank charges are to high for me.

8. How to contact the author

I wrote this soft for everyone, so, feel free to send me your suggestions
and remarks that I will consider for making the next versions.
If you discover some bugs, send me a precise description of the
circumstances in which the bug appear and your material and software
configuration.

Snail mail :

Arnaud HASENFRATZ
15 rue des Jardins
67560 ROSHEIM
FRANCE

Internet :

E-mail : [e-mail]

Warning : I do not have access to my e-mail account during school holidays.